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&S ~ 
&T 


&U 


Unset bit 
&X=[n] a ZB% in 70% 


Set x Screen coordinate 
(8-279, O=left) 

Set y Screen coordinate 
(8-191, O=top) 


&Y=[n] 


[str]= a list of acceptable words 
and command options 

[n]= any legal BASIC constant or 
simple variable; integer 
or real 


&A and &0 Options 


Option 


Eff 
<c> pe 


Require capit 
rr <*Pitalization 


uded in && or &0 


SIS wipe ignore words wl ,w2 


<L> Judge on detters only 


(ignore capitalization) 
<M> Accept words that are 
Probably Misspelled 
(C&M Markup not shown 
if <M> is in effect) 
<p> Treat Punctuation like 
regular characters 


<Siewleiie ae rene wl ,w2 
Synonyms 


(eienag 


<V, n$ > Embed contents of 
simple string 


Variable n$ in command 


<w> Accept words in 
any order 


<X, wl,...> Reject responses 


containing excluded 
words wl,w2,... 


<X> Exclude no words (all 
extra words accepted) 


n$ = any BASIC simple variable 
string name 

wl, w2, etc. = words expected 
in student response 


Always place all options that have 
no word list (such as <C> or <p>) 
before options that contain word 


lists. For example: 


&A"<L><W><X><S, hue, color> red green" 


ZBA 
Z.C% 
ZE% 
ZK% 
ZLh 


2N% 


20% 


ZW% 


g, 1=Corr 

pit to be cn Carat a 
ner Aare responses 
at &1 

6A error return 

(J=0K, 1-9 error) 

ASCII code number of key 
detected by &1, &P, &K, or &T 
Maximum allowable length of 
student response string 
Numerical position of closest 
matching answer command in 
sequence of &A,&0,&0,.... 
Object byte that ig altered by 
&$ or & 

Match to wrong response 

(O=oK, 1=Wrong, 

>1=Partial match) 








Usefy) « 
Error Codes for &A and &0 Commands ul. Standard Table" Effects 


(in ZE% after &A or &0 executed) 

























FONT SELECTION 













anne Standarg- | 
=< = ZEZ Indicates Sateeciecy cts % | Pocket Reference Guide 
Alternate Font @F 
i) No errors Standard Font @s aor 
ee 1 Student input string a } 
Bate] long (>25@ characters c 
ee a sexi tal 2 ties input string too Fixed Seer POSITIONING 

long (>25$ characters) Proportional spacin @p LESH 

3) Quote mark missing at _. Backspace = @p 
start of &A or &0 | Carriage Return (1 line) GR 

4 No comma or space between Carriage Return (1.5 line) | CTRL-C 
V and BASIC variable: | 
<VC$> should be <V,C$? | MARGIN CONTROL 

5 No > at end of option: Set new margin @CTRL-P 
<V,C$ should be <V,C$> | Automatic CR 

6 Bad string variable name | at right margin @CTRL-R 

7 Too many words in student Wrap-around after Distributed by ego 
response (>32) right margin @CTRL-Q ee: 

8 Too many total student Re OS ae - 
and author words (student | : UPPER/LOWER CASE CONTROL | A Division of Van Nostrand Reinhold 5 
words x author words>224) Show all letters as upper case | Company, Inc. ee 

9 <C>, <M>,<P>,<U> not before | Show all letters as lower case goon 


author’s words Show letters as actually coded 


P.O. Box 192, Wentworth NH $3282 
Toggle upper/lower case 


693/764-5831 


aesee 








SUPERSCRIPTS AND SUBSCRIPTS 














Useful PEEKS and POKES 


f Superscript au 
BASIC program space left (in bytes): { Subscript @p } Copyright 
16384 - PEEK(175) — 256*PEEK(176) Locking superscript @ ‘ 1982 
| Locking subscript Q@,; by 
Screen location of next output: ‘ : Allen Avner 
X = PEEK(224) + 256*PEEK(225) ; SPECIAL DISPLAY MODES Stanley Smith Paul Tenczar 
Y = PEEK(226) j ERASE mode @ 
OVERSTRIKE mode Gt EnBASIC is a registered trademark of 
EnBASIC special display functions REWRITE mode QS Computer Teaching Corporation 
On=POKE 24599,0  Off=POKE 24599,1 EXCLUSIVE-OR mode @% 
INVERSE mode @& 
* 
EnBASIC Pointer Addresses NON-PLOT mode @ 


Normal Display Table 24589,24581 
Alternate Display Table 24582,24583 
Key Table 24584,24585 
& Continue Address 24586,24587 
First loc. above EnBASIC 24588, 24589 
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Here is a working example. Press CTRL-RESET and type it in 
(or copy program EX IV-6 from your Demo diskette). 


Program Comments 


NEW 

119 &N Prepare for New interaction 

129 PRINT"“WHAT GOES *MEOW’?” 

139 &1 Input response 

149 6&A"<S,@LCAT, FELINE>" Answer command with synonyms 
Mark up the answer 


159 &M 
169 IF ZA% THEN 399 If OK, go to 399 
179 72K2z=9 Zero ZK% as a flag 


189 HTAB 19: VTAB 1¢ Location of help messages 
199 IF ZCZ=1 THEN PRINT"@LBEGINS WITH ’C’™ 


299 IF ZCZ>1 THEN PRINT"@LTRY ’CAT’” 
219 IF ZK% THEN 139 Return to input on second pass 


229 &T: IF NOT ZK% THEN 229 Loop until keypress 

230 GOTO 189 Keypress~-erase help message 
399 HTAB 19: VTAB 19: PRINT “GOOD!” 

RUN 


Lines 119 to 159 set up the question, allow input, specify 
the answer, and provide the markup. Line 16% tests to see 
if the answer is right (ZA%= 1) and, if it is, gives the 
message "GOOD!" and moves on beyond the question. 


If the answer is not right, 7K% is zeroed as a flag on line 
179. Line 189 positions help messages on the screen. On 
the first attempt to answer the question, the BASIC variable 
7ZC%Z is set to 1 by the answer command; thus, the hint on 
line 199 is printed on the screen. More than one try gives 
the hint on line 209. Next, line 219 checks the value of 
7K%. Since ZK% was set to zero on line 179, the test fails 


and the program goes on to 226. 


, on line 229 Tests the keyboard to see if 


The command, &T 
If no key has been pressed, 


the student has typed a key- 
2K% is not altered from the value of 9 set on line 179. As 


long as no key is pressed, looping continues at line 229. 
Once any key is pressed, 7K% is set to a non-zero value, and 
control falls through to line 23 and thence to line 189 and 
once again through the help message. Since EnBASIC, by 
default, writes in exclusive~or mode, rewriting the help 
message over itself results in automatic erasing of the old 
message (a very handy feature of exclusive-or mode!). We 
now have a non-zero value in ZK%, so this time when we come 
to line 219, we branch back to the &I on line 13% where the 
key pressed at &T is acted on. Thus, a student can type 
"felin", press RETURN, receive feedback about the missing 


"e", type that letter, and immediately see the corrected 


e , 
word, ready for rejudging. Such approaches do much to make 


interaction with the computer a friendly experience. 


39 


Key-Buffering and Single-Key Sensing 


Studen 
eee aera made up of natural-language strings in a 
CAL. The &1 ees sc ee one important aspect of advanced 
an 
such foponses ieaeacee Phe pe he acta 


ae gists aspect of advanced CAI consists of real-time 
ae action with a computer that is busy updating 
ete ons or graphics. Designing such CAI environments 
esa ae of controlling access to the keyset and 
re ae ndividual keys both reliably (keys must not be lost 
sinterpreted) and efficiently (key processing should 
not degrade simulations). The commands described in this 
section provide a variety of methods for meeting these 
needs. Among these commands are the &P and &T commands 
which have already been used in some of our examples. 


Key Buffering 


EnBASIC makes use of a multi-key input buffer to prevent 

loss of keys entered during simulations or graphics 
processing. The various pause, delay, and input commands 
treat keys in this buffer differently. All but &T remove 

the oldest key from the buffer. &T tests for keys but does 
not alter the buffer -- any keys in the buffer remain there. 
All EnBASIC commands place keys from the keyset into this 
multi-key buffer. However, keys entered during long, 
complex non-EnBASIC computations do risk being lost. To 
prevent such loss, &T commands can be placed in these parts 
of the program. Keyset entries are then stored in the key 
buffer for later detection by the program. Execution of the 
&N command clears the multi-key buffer to prevent unintended 
interaction between sections of the lesson. 


&P The PAUSE Command 


The pause command, &P, causes a program to pause until a 

key is pressed. The ASCII code of the key used to break the 
pause is placed in the BASIC integer variable ZK% and 
removed from the input buffer. At the same time, the number 
of seconds spent between encountering the &P and pressing a 
key is placed in the BASIC real variable ZT. 


The &P provides an easy way to check for specific single 


keys. For example, to allow only RETURN to function, use: 


196 &P: IF ZK% <> 13 THEN 199 
ressed does ZK% contain the ASCII code 


n the program looping back to 
Since ZT is zeroed each time &P 


Only if RETURN is Pp 
13. Any other key results i 
the beginning of line 1p. 
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